home *** CD-ROM | disk | FTP | other *** search
/ Shareware Grab Bag / Shareware Grab Bag.iso / 081 / sirius50.arc / SIR050D.ARC / SIRIUS.HLP < prev   
Text File  |  1987-07-10  |  16KB  |  485 lines
  1.  
  2.            Sirius Help text -- version 0.50
  3.            ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  4.  
  5. ==> ?
  6.  
  7.  
  8.   This  "Fido-compatible message base manager"  should
  9.      eventually  cover  almost  all of  your  MESSAGE-
  10.      (not FILE-)specific processing needs.
  11.  
  12.   If there is  ANY Fido-compatible message  capability
  13.      which  you  desire  but  don't find here, contact
  14.      Micro Solutions NOW.
  15.                                          --- Bob Klahn
  16.  
  17.  
  18. {pause}
  19.  
  20. Message selection:
  21.      A : Area change
  22.  
  23.      B : get most recently Tagged message, regardless of area
  24.          (see Tag command)
  25.  
  26.      H : get Highest-numbered message
  27.      L : get Lowest-numbered message
  28.  
  29.      N : get Next message IN CURRENT GROUP
  30.      P : get Previous message IN CURRENT GROUP
  31.  
  32.      Z : get message at Zenith, i.e., highest-numbered message yet seen
  33.  
  34.      + : get next LINKED message
  35.      - : get previous LINKED message
  36.  
  37.      # : get a specific message number (NOT the "#" character itself)
  38.  
  39. {pause}
  40.  
  41. Single message operations:
  42.      C : Copy message, to disk file or printer
  43.      D : Doctor current message
  44.      K : Kill message
  45.      M : Move message somewhere else
  46.      S : Show (current) message in complete detail (despite View settings)
  47.      T : Tag message (assign To A Group, or for recall by Back command)
  48.  
  49.      E : Enter new message
  50.      F : Forward message (not yet implemented)
  51.      R : Reply to message
  52.  
  53. {pause}
  54.  
  55. Miscellaneous options:
  56.      G : work with Groups of messages
  57.      I : pause for keyboard Input (see @Keyin string function)
  58.      O : Output text to screen
  59.      W : Wait one or more seconds
  60.      Y : the real You, with aliases
  61.  
  62.      ! : script input/output; if-otherwise/while
  63.      J : Jump to DOS and optionally execute a program or batch file
  64.      Q : Quit to DOS
  65.      V : View (what you want to see on your screen)
  66.      X : novice/average/eXpert Sirius user
  67.      ? : this display
  68.  
  69. ==> Area (?
  70.  
  71. Area selection options:
  72.      K : "also Known as", i.e., the area's EchoMail identifier
  73.      N : Netmail area
  74.      # : a specific area number
  75.  
  76. {pause}
  77.  
  78. ==> Area (Known as (?
  79.  
  80. So you haven't quite got a handle on these handles, eh?  It's like this:
  81.  
  82. These optional  identifiers are  usually associated  with EchoMail.  When
  83. building  its  area  table  file  (SIRIUS.ART), Sirius will include these
  84. identifiers  if  EchoMail-formatted  file  AREAS.BBS  is available in the
  85. Sirius home directory at that time.
  86.  
  87. You need not key the  entire identifier, as partial matches  are allowed;
  88. the match is on  the first occurrence in  the area table, ordered  low to
  89. high.  Thus if  area #1 is  "GENERAL" and area  #2 is "GENEALOGY",  a "G"
  90. will select area #1, as will "GE", "GEN", and "GENE"; "GENEA" and  beyond
  91. will select area #2.
  92.  
  93. ==> Copy (?
  94.  
  95. Copy this message elsewhere, with or without all the messages linked to it:
  96. perhaps to a different area, probably renumbered.
  97.  
  98. Message links are dropped on all single-message copies.
  99.  
  100. {pause}
  101.  
  102. WHAT to copy:
  103.      C : prepare to copy current message Chain (toggle; single = default)
  104.  
  105. WHERE and HOW to copy it there:
  106.      A : prepare to copy to a different message Area (default = current area)
  107.      F : to a flat ASCII File  (immediate)
  108.      P : to a Printer on LPT1: (immediate)
  109.  
  110.      D : prepare to copy Down (just above next-lower message)
  111.      H : prepare to copy to end of area (High)
  112.      L : prepare to copy to beginning of area (as Low as possible)
  113.      U : prepare to copy Up (just below next-higher message)
  114.      W : prepare to copy into When-entered order
  115.          (When implemented, THIS will be the default.)
  116.      # : prepare to copy using a specific message number
  117.  
  118.      S : message body will be "Stamped" with source and date/time of copy
  119.  
  120. {pause}
  121.  
  122. Actually performing THE COPY, and possibly "going along for the ride":
  123.      G : "Give" message(s) to destination but stay where you are
  124.      T : "Take" (go along with) message(s) to destination
  125.  
  126.      ? : this display
  127.  
  128. ==> Doctor (?
  129.        ____/
  130.       /
  131.      B : Body of msg
  132.      D : Date/time
  133.      F : who From
  134.      L : Links ("reply to", "see also")
  135.      N : Netmail
  136.      P : "(Private)" status
  137.      R : "(Recv''d)" status
  138.      S : Subject
  139.      T : who To
  140.      ? : this display
  141.  
  142. ==> Doctor (Body (?
  143.        __________/
  144.       /
  145. {file SIRBODY.HLP}
  146.  
  147. ==> Doctor (Links (?
  148.        ___________/
  149.       /
  150.      U : Unlink               \  Only the current message is doctored now;
  151.      - : Alter backward link   >  message linked-to may also
  152.      + : Alter forward link   /   require doctoring
  153.      ? : this display
  154.  
  155. ==> Doctor (Netmail (?
  156.        _____________/
  157.       /
  158.      A : "(file Attchd)" status
  159.      F : net/node From
  160.      H : "(Hold)" status (SEAdog only)
  161.      I : "(In transit)" status
  162.      K : "(Kill/sent)" status
  163.      L : "(Local)" status
  164.      O : "(Orphan)" status
  165.      R : Request from destination (SEAdog only)
  166.      S : "(Sent)" status
  167.      T : net/node To
  168.      X : "(eXpress)" status (SEAdog only)
  169.      ? : this display
  170.  
  171. ==> Doctor (Netmail (Requests (?
  172.        _______________________/
  173.       /
  174.      A : "(Audit req)" status  \
  175.      F : "(File req)" status    \
  176.      R : "(Receipt req)" status  > SEAdog only
  177.      U : "(Update req)" status  /
  178.      ? : this display          /
  179.  
  180. ==> Enter (?
  181.  
  182. Pretty basic now:  single-pass word-wrapped message entry;
  183. see also "You" command.
  184.  
  185. ==> Doctor (Body (Append (?
  186. ==> Enter (Body (?
  187. ==> Reply (Body (?
  188.  
  189. {file SIRCTRL.HLP}
  190.  
  191. ==> Enter (Bodywork (?
  192. ==> Reply (Bodywork (?
  193.        _____________/
  194.       /
  195. {file SIRBODY.HLP}
  196.  
  197. ==> Enter (Handling (?
  198. ==> Reply (Handling (?
  199.       ______________/
  200.      /
  201.     H : "(Hold)" status (SEAdog only)
  202.     K : "(Kill/sent)" status
  203.     X : "(eXpress)" status (SEAdog only)
  204.     ? : this display
  205.  
  206. ==> Enter (Requests (?
  207. ==> Reply (Requests (?
  208.       _____________/
  209.      /
  210.     A : "(Audit req)" status  \
  211.     F : "(File req)" status    \
  212.     R : "(Receipt req)" status  > SEAdog only
  213.     U : "(Update req)" status  /
  214.     ? : this display          /
  215.  
  216. ==> Forward (?
  217.  
  218. Change a message's "To:" field and optionally prefix an intro.
  219.  
  220. ==> Group (?
  221.        ___/
  222.       /
  223.      D : Define a group, also making it the active group
  224.      U : Use a group (make it the active group)
  225.  
  226.      C : Copy active group       \
  227.      K : Kill active group        \  Not yet implemented;
  228.      M : Move active group        /  use While loops for now.
  229.      R : Renumber active group   /
  230.  
  231.      H : display message Headers, one screen line per message, in active group
  232.      L : display List of message numbers in active group
  233.  
  234.      ? : this display
  235.  
  236. ==> Group (Define (?
  237.  
  238. This powerful facility allows you to define
  239.  
  240.                          LOGICAL MESSAGE GROUPS
  241.  
  242. by means of general expressions, just as with Sirius WHILE loops
  243. and IF tests.  (See help for main-menu "!" command.)
  244.  
  245. A few examples:
  246.  
  247.     @Body CO 'AREA:TECH' OR @Body CO 'AREA: TECH'
  248.     @DaysOld GT 30
  249.     @InTransit AND @DaysHere GT 4
  250.     @Msg CO 'Telebit' OR @Msg CO 'blazer'
  251.     @Msg NC 'FLAME'
  252.     @NoBody AND @FileAttach AND @Subject CO 'NODEDIFF'
  253.     @Private AND @Received
  254.     'Hello, Bob!' IN @Subject
  255.     150 EQ @ToNet AND 0 EQ @ToNode
  256.     @Xpress AND NOT @Sent
  257.  
  258. {pause}
  259.  
  260. Groups are identified by a single letter of the alphabet, A through Z.
  261. At startup, group A is active.
  262.  
  263. Any group not explicitiy defined (by this Group Define command!) is
  264. assumed to contain all messages in the current message area.
  265.  
  266. The main-menu "Next" and "Prev" commands automatically skip over messages
  267. which are not members of the current group.
  268.  
  269. {pause}
  270. {file SIREXPR.HLP}
  271.  
  272. ==> Jump (?
  273.  
  274. Jump to DOS (and come back using the DOS "EXIT" command).  You'll need to
  275. borrow some memory for this one (especially considering how Sirius eats it
  276. up managing messages)!  By jumping to a DOS batch file (whose last command
  277. is EXIT) under control of a Sirius batch file, and coming back here with
  278. that Sirius batch file STILL IN CONTROL ... all sorts of wonderful things
  279. become possible!
  280.  
  281. ==> Kill (?
  282.  
  283. Kill (erase, destroy, wipe out, annihilate) this message (are you SURE??)
  284.  
  285. ==> Move (?
  286.  
  287. Move this message elsewhere, with or without all the messages linked to it:
  288. perhaps to a different area, probably renumbered.
  289.  
  290. Message links (- and +) are retained and updated if possible, i.e.,
  291. unless a single message is being moved to a different message area.
  292.  
  293. {pause}
  294.  
  295. WHAT to move:
  296.      C : prepare to move current message Chain
  297.          (toggle; default = single message only)
  298.  
  299. WHERE and HOW to move it there:
  300.      A : prepare to move to a different message Area (default = current area)
  301.      F : to a flat ASCII File  (immediate)
  302.      P : to a Printer on LPT1: (immediate)
  303.  
  304.      D : prepare to move Down (just above next-lower message)
  305.      H : prepare to move (renumber) to end of area (High)
  306.      L : prepare to move (renumber) to beginning of area (as Low as possible)
  307.      U : prepare to move Up (just below next-higher message)
  308.      W : prepare to move into When-entered order
  309.          (When implemented, THIS will be the default.)
  310.      # : prepare to change to a specific message number
  311.  
  312.      S : message body will be "Stamped" with source and date/time of move
  313.  
  314. {pause}
  315.  
  316. Actually performing THE MOVE, and possibly "going along for the ride":
  317.      G : "Give" message(s) to destination but stay where you are
  318.      T : "Take" (go along with) message(s) to destination
  319.  
  320.      ? : this display
  321.  
  322. ==> Out (?
  323.  
  324. This command allows you to output explanatory text to the screen, and is
  325. primarily intended to be used in tutorial scripts.
  326.  
  327. ==> Quit (?
  328.        __/
  329.       /
  330.      B : quit to Bbs, i.e., to Fido/Opus/SEAdog home directory
  331.      H : quit "Here", i.e., to current directory
  332.      I : If there is an input error, what should happen?
  333.      S : quit to Sirius program directory
  334.      ? : this display
  335.  
  336. ==> Reply (?
  337.  
  338. Almost the same as ENTER, except for linking;
  339. see also "You" command.
  340.  
  341. ==> Reply (Bodywork (?
  342.  
  343. The "Doctor Body" command set.  I can't show it to you right here <sob!>,
  344. because Bob Klahn hasn't taught me how to handle cross-references yet!
  345. Perhaps you should just hit the ENTER key now to save this message as is.
  346. Then use the "High" command followed by "Doctor Body" and ask for help
  347. again; "HDB?" for short.  Such is life in the big city.
  348.  
  349. ==> Reply (Prefix (?
  350.  
  351. Press the ENTER  key now if  you do NOT  want the body  of the message to
  352. which you are replying to be included in your response; you will then  be
  353. prompted for line #1  of your reply, just  as if this "Original  prefix?"
  354. question had never been asked.
  355.  
  356. If you  DO want  to quote  all or  part of  the message  to which you are
  357. responding, then key in the  character(s) which you would like  to PREFIX
  358. to each quoted line.
  359.  
  360. When Sirius next asks  you if you want  to "prefix author's lines  only",
  361. answer "y" or "Y" IF you want the prefix your prefix attached ONLY TO the
  362. replied-to message AUTHOR'S LINES.
  363.  
  364. The recommended choice for such a prefix is something clearly identifying
  365. the author of the original message, such as "BK>" for yours truly.   Note
  366. that any "BK>" already present  in the replied-to message becomes  "BK>>"
  367. in the reply itself.  I encourage you to experiment!
  368.  
  369. {pause}
  370.  
  371. If "View Until" is active AND  the message being replied to has  NOT just
  372. been viewed in detail (i.e.,  using the "Show" command), then  only those
  373. lines  preceding  the  first  occurrence  of  the "View Until" string are
  374. included.  The general idea is to support "WYSIWYG": What You See Is What
  375. You Get.
  376.  
  377. :-) Be creative in choosing your reply prefixes.  I'll be on the lookout
  378. :-) for YOUR "designer quotes", as Chuck Lawson calls them.
  379.  
  380. ==> Tag (?
  381.  
  382. TAG a message: right now this  just remembers a single message, for  the
  383. "Back" command to return to.
  384.  
  385. Later on you will be able, using this command, to assign a message
  386. To A Group ("TAG") for subsequent processing.  You'll  tend to use this
  387. to do things you can't seem to do any other way.
  388.  
  389. Tagging an already tagged message causes the "zenith" (highest-numbered
  390. message read) to be reset to the current message number.
  391.  
  392. ==> User (?
  393.  
  394. User base operations.  Yes, folks, USER.BBS maintenance is going to be
  395. part of Sirius.  Consider this one embryonic at best.  But expect to be
  396. able to do things like automatically generating messages to people who
  397. don't fill out your questionnaire to your satisfaction.  THAT should
  398. get your mind buzzing!
  399.  
  400. ==> View (?
  401.        __/
  402.       /
  403.      C : Continuously (i.e., not by screenfuls)
  404.      S : By Screenful (twenty-four-lines-at-a-time)
  405.  
  406.      F : message Flags (yes, no, or toggle)
  407.      U : Until occurrence of string in message body; case-sensitive.
  408.          E.g.,use this to avoid looking at Echomail SEEN-BY's.
  409.  
  410.      M : Memory management.  Watch your memory slowly disappear.
  411.          I've forgotten everything else I was going to say ...
  412.      X : level of eXpertise (low, medium, high) in using Sirius
  413.  
  414.      ? : this display
  415.  
  416. ==> Wait (?
  417.        __/
  418.       /
  419.      A : pause until Any key is pressed
  420.      # : pause for a specific number of seconds (or until ESC key is pressed)
  421.  
  422. ==> You (?
  423.  
  424. The real YOU!  If you don't tell Sirius who You are (is?), then SIRIUS won't
  425. mark messages as "(Recv'd)" that You read (reads?)!  And without You, Sirius
  426. will prompt for the "From:" field during message entry, reply, or forwarding.
  427. You can also have aliases, so that, for example, both  messages  addressed to
  428. "Bob Klahn"  and messages  addressed to "Sysop"  will be marked as "Recv'd)".
  429. The flip side is that You can avoid "receiving" messages until You have (has)
  430. acted on them, or at least gotten to first base.  Who's on first?  What?  No!
  431.  
  432. ==> ! (?
  433.  
  434. THIS FACILITY ALONE IS ... why YOU will want to GET Sirius.
  435. ~~~~ ~~~~~~~~ ~~~~~ ~~     because ...
  436.    ... it allows you to AUTOMATE MUCH MORE of your total critter care:
  437.        ANYTHING you can key-enter into Sirius, you can also
  438.           (1) "play" from a Sirius command file, A-N-D
  439.           (2) have Sirius record to such a command file for later use,
  440.               either as a session record or for subseqent playback.
  441.  
  442.      I : If condition is true
  443.      O : Otherwise:  previous "if" condition is false
  444.      W : While condition is true
  445.      E : End most recent If, For, Until, or While
  446.  
  447.      D : Set inter-command Delay, for use with command file Playback
  448.      L : Log text to file
  449.  
  450.      P : Play back Sirius commands from a (previously recorded/edited) file
  451.      R : Record (or stop recording) Sirius commands
  452. {pause}
  453. {file SIREXPR.HLP}
  454.  
  455.      ? : this display
  456.  
  457. Ah yass, Fido, Opus, and SEAdog can almost run themselves now ...
  458.  
  459. ==> ! (Delay (?
  460.  
  461. Use this to slow down input command file execution.  Lotsa reasons
  462. you might want to do this, whether you're around to watch or not.
  463. HELLOBOB.SIR uses this.  Think about it.
  464.  
  465.      K : Keyboard delay: until next key is pressed
  466.      T : Timed delay, in seconds
  467.  
  468. ==> ! (Log (?
  469.  
  470. This command allows you to append arbitray text to the disk file of your
  471. choice.  If you name a disk file which does not exist, it is created.
  472.  
  473. Examples: (1) Write a line of dashes to a file to which you are also
  474.               copying messages, to serve as a "divider".
  475.           (2) Write a line to a file, under script control, only if certain
  476.               conditions are met.
  477.  
  478. Note that file logging operations can also be accomplished via
  479.  
  480.    Jump ('Echo text-to-be-logged >> LOG.TXT'),
  481.  
  482. or by using echo commands in DOS batch files.  In particular, entire
  483. Sirius scripts can be generated and immediately invoked in this manner.
  484.  
  485.